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PRODUCT SPECIFICATION 


Software Release Level Mark 7.0. 

Formerly released as section three oF Ps. S.° 2710 9579, 
B1800/B1700 MCP UTILITIES. 

fs 2-2: Added exception to Phase l. 

VW ~ Software Release Level Mark 19.0, 


1-1 Added "DSKAVL" to list of options. 


2-1 Rewrote first 3 paragraphs of "OPERATING INSTRUCTIONS" 
section, 
Changed value of ALPHA. 
Added "DSKAVL, ALPHA" to "SENSE SWITCHES," 
Added ''SENSE SWITCH 6'' section. | 


2-2 ‘Updated "MAP or CHECK is set" anaien. im Phased Section. 


(2-3 Updated "INVALID DFH.HDR.SIZE" error message. 
| Added "INVALID BPS NUMBER" error message. 


2-4 Updated '"DATA-RECORD" format and added “CREATE “TIME” and 
| "UPDATE _DATE. a 


3-1 Updated 5, 6, 7, and 9. 
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GENERAL DESCREPILON 
DISKMAP/UTILITY accesses the MCP disk directory and available 


tables to produce a “map" of the disk or one of the options 


Listed below. 


CHECK sort disk information by address». check for disk 
| rntegrity errorsSe | | 


MAP Causes listing to be printing during disk 
| integrity check. Sets CHECK option by default. 


ALPHA Sort disk information alphabetically by file-names 


print in a format similar to a KA listing. 


SAVE Create a fite on disk containing the data printed 


during ALPHA tn a format accessible by UPL/COBOL 


progr amSe 


DECK , Punch a deck o f ‘cards containing the file-names of 


att files on disks one per card. 
DSKAVL Create tisting showing all svaaiaon areas of disk 


as well as totals of areas» segments» and the size 
of the largest availavle area. 


Name | | : | oo Number 
81800781700 NCP tI” se Pe Se 2212 5462 
 $1800/81700 Software Operational Guide 1968731 
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OPERATING INSTRUCTIONS 


DISKMAP/UTILITY is initiated by an execute statement. The 
program generates an ACCEPT message requesting the unit~mnemonic 
of the disk to be mapped and also any desired options. If the 


system has multiple system drives» specifying one of those drives 
causes all of them to be mapped. 


if the user does not speci fy any options via the ACCEPT messages 


the program sets MAP» CHECK» DSKAVL» and ALPHA by default. 
The execute sequence is illustrated below: 


EX DISKMAP/UTILITY. 

DISKMAP/UTILITY =1 BOJe oe. 

% DISKMAP/UTILITY =1 ENTER <UNIT“MNEMONIC> ANDO JPTIONCS). 
LAXDPA MAP DECK DSKAVL | 


SENSE SWITCH 9 


The program switches may De used to specify the options» thus 
avoiding the ACCEPT messagee If the user wishes to map the 
system disk» setting switch © to some non-zero value will 
automatically produce this resulte {t should be noted» however» 
that the program cannot access a user disk with switch 0 set tn 


this manner. To access a user disk» switch zero must be set to 
zero and the ACCEPT message must be used. | | , 


SENSE SWIICHES 1» 2> 3+ 4 


These switches control the options. Setting any one of these to 


a nonwzero value will suppress the option portion of the ACCEPT 


message and set the options as indicated below: 


SWITCH | VALUE | OPTIONS SET 
1 1 ss CHECK 
1 2715 MAP» CHECK 
20 | : ALPHA 
2 2-15 DSKAVL» ALPHA 
3 1-15 | SAVE 
4 


1715 DECK 


This switch may be used to override the empty mix requirement for 


the mapping of system disks. If switch 6 is set to a non-zero — 


values the mapping of systems disk is allowed even though joos 


other than DISKMAP/UTILITY are executing. It should be noted 
there coutd possibly be discrepancies in the war Listing due to. 


temporary areas of disk being used Dy the programs which are 
-executinge Also note that this switch has no relevance or effect 
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for disks other than system disks» and should be used only when 
necessarye | 


PRUGKAM EXECUTION | 


The DISKMAP/UTILITY program executes in three ‘wiseess These are 
explained bdelow.e 


Phase l 

Access the directory » available tadles» and headers on the 
specified disk> pDuild temporary work files for use in the other 
phasese | 


During this phase» nothing may be allowed to disturb the disk 
being mapped» or the output may be in errore This means that no 
Library maintenance instructions CREMQVE or CHANGE) may ode 
per formed» nor any message that affects the disk directory or. 
available tables Cew.ge» XC» XD» Th» SL) #£=AlSo» no programs may 
pe scheduled or executed while mapping systems disk. There 1s 
one exception to the Phase 1 prohibition against disk activity» 
and that exception applies only to a systems disk. If neither 
MAP or CHECK is set» or tf switch 6 1S non“zeros other disk 
activity is permitted. . 


Phase 2 


This phase is invoked only if MAP or CHECK is specified. It 
consists of sorting the disk information obtained during the. 
first phase cy addressee then checkirg it for integrity errors. 


if MAP is specified» a listing of the disk areas by address will 
also be performed. | : 


The tisting produced by the MAP option will contain one line for 


each logical "chunk" of disk space» giving the starting and 
ending addresses» the size in disk segments» a description of the 
chunk» plus the area number and file~id for ail files. Any 


errors detected witt be identified sy a descriptive error 
messages as follows: : | 


MISSING DISK ARCA The specified ~ chunk of disk is. 


unaccounted for in att MCP directortes 
and avaitable tables. Note that the 


chunk may have been explicitly removed _ 
by an "XD". | 


QVERLAPPING DISK AREAS The specified chunk of disk is described 
| Dy more than one headers directory» or 
available table entry- : 


INVALID DFHeSELF = ‘The OFH.SELF address in the header is 
| _ not the same as the address from which 
the header was actuatly reade 


eel 
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DFHeAREAS.RQST > 105 The header requests more than 155 areas» 


the maximum allowed. 


ee AREAS.~CTR > OF He AREAS«RQST 


The count of areas in use in the header 
1s greater than the maximum numbder ‘of 
areas 1t requested to uS@e 


INVALIO DFH.HDR.SIZE © The DOFH.HOK.sSIZE field in the header is 
incorrect Ccosputed from: 
DFH.AREA.ADUR.OFFSET. t (36 * 

DF He AREAS*RQST))~ | 

INVALID DISK.SELF The DISK.SELF address in a directory 


segment its mot the same as the address 


from which the directory segment was 
actually read. | 


INVALID 8PS NUMBER | The Base Pack serial number contained in 
this continuation pack's Labels» does not 


match that in the DISK.ADDRESS. 


Areas of disk described as TEMPORARY wilt appear on the Listing 


when mapping systems disks these are work areas in uSe 9y 
— DPISKAAP/UTILITY and wilt be returned at program EOJ. | 


Phase 3 


This phase is invoked if ALPHA» SAVE or DECK is specified» It 
consists of sorting the disk header information by file-namer 
then producing the type of output requested. Any one or all of 


the three tyres of output may be produced during a single rune 


The file produced by the SAVE option has the following — 


attributes: 


internal "filename: "J SER™ 
external~file-name: "USER" 
record size: 1890 bytes 
records per block: 5 | 
areas: | 25 

Dlocks per area: — 100 


The information for each file on the disk will occupy from it to 4 ~ 
records in this file» depending upon the number of disk areas in 
use by the fite. The record format Cin COBOL notation) is as 


fottlows: 
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G1 DATA~REC ORD 


U2 
G2 
G2 
2 


FILE-IDENT 

RE CORD“COUNT 

HE ADER~DI SK-ADDRESS 
RECORO~SIZE 

RE CORDS“PER~BLUCK 
BLOCKS=PERAREA 


SEGMENTS“PER“AREA 
| AREAS“DECLARED 


AREAS@*INWUSE 
EQF*POINTER 
FILETYPE 


~CREATION“DATE 
LAST*ACCESS“DATE 


SAVE“F ACTOR 
CREATE ~TIME 
UPDATE “DATE 
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Pic 
PIC 
PIC 
PIC 
PIC 
PIC 


Pic 


PIC 
PIC 


PIC 


PIC 
PIC 
PIC 
PIC 
PIC 
PIC 


01 AREA~ADORESSES REDEFINES DATA“RECORD. 
| AREA~ ADDRESS OCCURS 39 PIC 


02 


The RECORD-“CGUNT fietd contains the count 


required 


SERTAL“NUMBER“FLAG is U» 


describing the disk address- 


Note that the entire AREA- ADDRESS> 


unallocated areae 


The AREA-ADDRESSES 
L80-byte record Cexcept for the first 


field wilt 


record). 


Pe Se 


XC 20). 


9 
9€12) 
9(04) 
9094) 
9(06) 
9( 06) 
999 

999 


9097) 


999 
9(05) 
9€05) 
9004) 
9€07) 


9€95) 


9€ 12) 


for the file description. For examples» 
less than 16 areas in use CAREAS“IN“USE)> 


ve 


The 


COMP. 
COMP. 
COMP. 
COMP. 
COMP. 
COMP. 
COMP. 
COMP. 
COMP. 
COMP. 
CUMP. 


COMP. 


COMP. 
COMP. 
COMP. 


COMP. 


zero 


first 


2222 2632 (€B) 


of how gany records are 
if a file has 
it will only require 1 


recor d> for 16745 areas in use» it will require 2 records? and 
so forth. | | | 
Disk addresses are stored in the following format: 
91 DISK-ADDRESS~FORMAT. 

02 SERIAL“NUMBER@FLAG PIC 9 COMP. 

92 PORT= NUMBER PIC 9 COMP. 

G2 CHANNEL “NUMBER PIC 99 CUMP . 

02 UNIT“NUMBER PIC 99 COMP. 

02 DISK-ADDRESS PIC 9€06) CUMP. 
if the SERIAL“NUMBER “FLAG 1s l> PORT-“NUMBER» CHANNEL“NUMBER> and 
UNIT“NUMBER are not useds DiSK“ADDRESS contains a disk cartridge 
or disk pack serial number (Cfor multicpack files). the 


the other fielis contain decimal. values 
an 


are stored using the above format 30 to each 
15 


AREA" ADDRESSES are stored in the second half of the first recorder 


as shown below. 


oa aa eae rm thereat tte leaned 
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AREA NUMBER RECORD NUMBER SUBSCRIPTS 

i- 215 1 16 7 39 

15 = 495 | 2 1 - 39 

46 7 795 3 1 - 39 

76 7 105 4 1 - 30 
Thuse the address = for. area number 3 1s located in 


ARE AW@ADDRESSC15) of record #13 the address for area nuasber 30 is 
Located in AREAtTADDRESSC15) of record #23 =and so forthe 


VISKMAP/UTILITY requires approximately 3900 segments of system 
disk for work file space and sorting if either the MAF or CHECK 
opttons are specified-s- Disk requirements for the files used by 
the other options will vary» depending upon the number of files 
contained on the disk being accessed. 
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PROGRAM ERROR 


An attempt to read disk has failede- Possibly due to invatid 
por t/channet/unit>s diskwoff-tine»s or had destination 
address. A program memory dump wilt be done automatically» 
and execution wilt terminate. 


<unit™mnemonic> HAS BEEN DISTURBED-“"RUN TERMINATED. 


If mapping system disk» indicates that some job has been 


scheduled and/or gone to BOJ. If mapping a user disk»e 
indicates that the user count in the PACK INFO. TAGLE 15 No 
longer zeroe Program execution will terminate. 

INVALID OPTION: <option> 

An undefined option has been entered in the ACCEPT message. 


MISSING <unit=mnemonic>. 


A blank ACCEPT message was entered for the disk unit to be 
mapped.» Try again. 


INVALID UNIT"“MNEMONIC2 <unit=mnemonic> 


An undefined untt was entered for the disk to be mapped. 
Try againe | | 


UNIT IS NOT A DISK DEVICES <untt=mnemonic> 


A unit was entared that is not disk. Try again. 


UNIT IS OrF LINES <unit-mnemonic> 


The disk unit requested is not on-line. Try again. 


ACTIVITY MUST CEASE ON <unit-mnemonic> PRIOR TO PHASE 1. 


If mapping system disks the mix and/or schedule is stilt 


active. If mapping a user disk» the user count in the 


PACK»INFO.TABLE ts not zeroe . The program wilt wait until 


ail activity stops» then Degin executing phase lt. 


NO Cor <integer>) OVERLAP ERRORS AND NO Cor <integer>) 
OVERALL ERRORS DETECTED IN DISK INTEGRITY. 


Final information message displayed if “MAP™ or "CHECK" is. 


specified» indicating number of integrity or overtap errors 
founde | | 
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10. WORKFILE OVERFLOW. 
RE“EXECUTE WITH: "FILE WORK AKEAS=<integer>3" 


The workfile is not targe enough to hold atl the necessary 
recordse Program wittl terminates and should be re~executed 
with the Specified "FILE" statemente 

11. DU NOT DISTURB <unit-mnemonic> UNTIL FURTHER NOTICE. 


Displayed at the beginning of ohase 1 as a reminder that 
nothing may be atlowed to access the disk being mappede 


12. <unitcmnemonic> IS NOW AVAILABLE FOR USE. 


Displayed at the end of phase 1 to indicate that normal 
activity may resume on the disk being sapped. | 
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